home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / ups / genpower.000 / genpower / genpower-1.0.1 / README < prev    next >
Text File  |  1995-07-16  |  3KB  |  75 lines
  1. This is the 1.0.1 release of the genpower (Generic Power 
  2. Monitoring for Linux) package.  In reality, this is a maintenance 
  3. release of the unipower package under a new name.  I was 
  4. requested to change the name by a firm that is marketing software 
  5. under the name UniPOWER.
  6.  
  7.  
  8. NEW FEATURES:
  9.  
  10.  * Users can now select from preconfigured UPS and cable 
  11.    configurations at runtime.  With a sufficient body of UPS and 
  12.    cable configurations, this should allow most users to just 
  13.    compile genpower 'right out of the box' and select the desired 
  14.    configuration while installing.
  15.  
  16.  * genpower will return an error code if it is unable to kill the 
  17.    UPS's inverter during the shutdown process.  This allows for 
  18.    better error handling.
  19.  
  20.  * genpower can now use the serial data transmit line for 
  21.    inverter shutdown with the normal command syntax.
  22.  
  23.  
  24. WHAT GENPOWER DOES:
  25.  
  26. The genpower package is basically a hack of Miquel van 
  27. Smoorenburg's powerd daemon, which is distributed in the SysVInit 
  28. package.  The express aim of the genpower package is to add 
  29. additional functionally and a simpler means of configuring UPS 
  30. monitoring, in a full featured suite that can be configured to 
  31. work with most UPSs featuring an RS232 monitoring port.
  32.  
  33. Depending on the UPS, cable, and the manner in which the genpower 
  34. package is configured, the genpower package provides the 
  35. following features:
  36.  
  37.  * Line power sensing, to detect when the power has failed and 
  38.    initiate a delayed shutdown, or other appropriate actions.  
  39.    This facility also allows the system to cancel the shutdown if 
  40.    power is restored before the system is shutdown.
  41.  
  42.  * Low battery detection, to detect when the UPS's battery is 
  43.    running low and initiate an immediate shutdown.
  44.  
  45.  * Physical cable detection, to detect connection errors.
  46.  
  47.  * The ability to kill the UPS's inverter.  This shuts the 
  48.    inverter on the UPS off, to prevent the system from draining 
  49.    the UPS's battery after it has shutdown.  This allows the 
  50.    system to restart itself, as if the power had been turned on 
  51.    when line power is restored. 
  52.  
  53.    Additionally, this helps the UPS to retain enough power to 
  54.    deal with power yo-yos, where the power comes up and goes down 
  55.    several times before being fully restored.
  56.  
  57.  * The unitest program, included in the genpower package, will 
  58.    monitor the status of a serial line and report changes in the 
  59.    status of the line.  The information provided by unitest can 
  60.    then be used to configure the genpower package for your UPS 
  61.    and cable combination.
  62.  
  63. Instructions for configuring the genpower package are contained 
  64. in the documentation (genpower.docs) and should be read carefully 
  65. before proceeding.
  66.  
  67. Please let me know if you find any problems, if you have 
  68. suggestions for enhancing the package, or if you have information 
  69. on connecting genpower to a UPS that isn't covered in the 
  70. documentation.
  71.  
  72. Tom Webster
  73. webster@kaiwan.com
  74. 07/07/95
  75.